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About the Documentation Set 


This manual is part of a document set that describes the operation of the software 
provided with the Microtec Research assembler package. The ASM68K 
Documentation Set includes the following: 


1, The User’s Guide provides host computer and operating system-specific 
descriptions of how to invoke the assembler, linker, and object module 
librarian. 

2. The Reference Manual contains complete descriptions of the assembler 
syntax and directives, linker commands, and librarian commands. Sample 
program listings are used as examples for the assembler, linker, and object 
module librarian. Error and warning messages are described. 


3. The Installation Guide contains host computer and operating system- 
specific directions for mstalling the ASM68K package. 


Once the programs have been installed, the User's Guide can be used in conjunction 
with the Reference Manual. 


About this Guide 


The Microtec Research ASM68K User's Guide describes how to use Microtec 
Research’s ASM68K assembler package software. Detailed descriptions are given 
of the various ways to invoke the assembler, linker, and object module librarian. 
Additionally, command line options that let you control output listing and object 
module generation for the programs are described. 


This guide contains the following chapters and appendices: 


¢ Chapter 1, Introduction, provides a high-level description of the 
assembler, linker, object module librarian, the optional XRAY68K. 
debugger package, and the optional MCC68K Compiler. 


e Chapter 2, VMS User’s Guide, describes how to invoke the assembler, 
linker, and object module librarian. Command syntax and options are 
provided for a VAX host computer using the VMS operating system. 

*« Chapter 3, UNIX/DOS User’s Guide, describes how to invoke the 
assembler, linker, and object module librarian: Command syntax and 
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options are provided for host computers using a UNIX or UNIX-like 
operating system, PC-DOS, or MS-DOS. 


e Appendix A, HP 64000 Development System Support, describes how to 
use the ASM68K assembler package to generate HP 64000 object 
modules that can be downloaded and used with various Hewlett-Packard 


products. 


Notational Conventions 


Examples in this guide are identified by operating system name. The name UNIX 
refers to any UNIX or UNIX-like operating system, such as SunOS and HP-UX. 
The name DOS refers to both MS-DOS and PC-DOS systems. 


This guide uses the following conventions shown in Table P-1 (unless otherwise 
noted). 
Table P-1. Notatlonal Conventions 
Symbol Name 


Curly Braces Encloses a list from which you must choose 
an item. 


Square Brackets Encloses items that are optional. 
Vertical Bar Separates items in a list. 


Ellipsis Indicates that you may repeat the preceding 
item zero or more times. 


typewriter font Represents user input in interactive 
examples. 


punctuation Punctuation other than that described here 
must be entered as shown. 

italics Indicates a descriptive item that should be 
replaced with an actual item. All file name 
examples are in italics. 


Microprocessor References 
The 68000 family of microprocessors includes the 68000, 68008, 68010, 68012, 


68020, 68030, 68302, CPU32, and 68040. In this manual, they are referred to 
collectively as 68000. 


vi Microtec Research, Inc. 


(@ 


\\ 
CO) 


Preface Questions and Suggestions 
Se Teer ee ec ee eee EG EE I TE TT TTT, 


Questions and Suggestions 


To help us respond to questions or suggestions regarding the ASM68K assembler 
package, we have provided two response forms in the back of this guide. 


The first form is a Reader’s Response sheet, which is used to help us correct and 
improve our documentation. We always appreciate your comments, and by 
completing this form, you can participate directly in the revisions of future 
publications, The Reader’s Response sheet is directed to Technical Publications. 


The second form is a Software Performance Report which should be completed if 
you encounter any errors or problems with Microtec Research software. This report 
is directed to Technical Support. 
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Components of the Microtec Research ASM68K Package 


The Microtec Research ASM68K Assembier package consists of an assembler, a 
linker, and an object module librarian. These components are described in the 
following sections. 


Assembler 


The Microtec Research ASM68K Assembler converts assembly language programs 
to relocatable object code. Object modules are suitable for linking with other 
modules or with libraries of modules. 


The assembler accepts source program statements that are syntactically compatible 

with those accepted by Motorola 68000 family assemblers. Many additional 

directives are provided for versatility. The ASM68K Assembler processes macros, 

conditional assembly statements, and compiler-like structure directives. The 

. assembler generates a cross-reference table as well as a standard symbol table. 
ax Generated code and data can be placed in multiple named or numbered sections. 


After assembly, the linker links the object modules, which are then suitable for 
download and execution on any Motorola 68000 family microprocessor. 


Linker 


The Microtec Research LNK68K Linker combines relocatable object modules into 
a single absolute object module, You can optionally generate object modules in the 
following formats: ‘ 


¢ Motorola S-Record 
. Hewlett-Packard 64000 format (HP-OMF) 
e JREE-695 


The linker also supports the combining of multiple relocatable object modules into 
a single relocatable module, which subsequently can be re-linked with other 
modules. This feature is referred to as incremental linking. 


C 
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If one of the input files is a library of object modules, the linker automatically loads 
only those modules from the library that are referenced by the other named object 
modules, The linker produces a link map that shows the final location of all modules 
and sections, and the final absolute values of all symbols. A cross-reference listing 
shows which modules refer to each global symbol. 


You can execute the linker in batch mode by using a command file or in a modified 
batch mode by specifying a command file plus additional object modules/libraries 
on the command line. The linker reports unresolved external symbols as well as 
errors that occur at link time, and prints these messages on the link map or on the 
terminal. 


Object Module Librarian 


The Microtec Research LIB68K Object Module Librarian lets you maintain a 
collection of relocatable object modules that reside in one file. Libraries let you 
automatically load frequently-used object modules without concern for the specific 
names and characteristics of the modules. 


By using the librarian, you can format and organize library files that will 
subsequently be used by the linker. You can add, delete, replace and extract 
modules, as well as obtain a directory listing of library contents. 


Other Microtec Research Products 


MCC68K C Compiler 


Microtec Research compilers emit either object code or assembly language code 
and optionally emit debugging information. To use the XRAY68K Debugger in 
high-level mode, you must compile programs with the debug option. This option 
causes the compiler to produce the required debugging information and pass it to 
the ASM68K Assembler, or the LNK68K Linker if object code is emitted directly 
by the compiler. 


CCC68K C++ Compiler 


The Microtec Research C++ Compiler is composed of a C++ preprocessor, C++ 
translator, and the MCC68K ANSI C Compiler. When you invoke the CCC68K 
C++ Compiler, you automatically invoke the C++ preprocessor and translator 
which translates your C++ code into C code. The MCC68K Compiler will then 
compile this C code into ASM68K assembly code or object code. If you use the 
comp;iler debug option, information necessary for debugging with the XRAY68K 
Debugger is included in the output file. 
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~ XRAY68K Debugger 
The XRAY Debugger lets you monitor and control the execution of high-level C, 
Pascal, or FORTRAN programs or assembly-level programs in the controlled 
environment of the host computer, thereby eliminating hardware-induced 
anomalies. By using XRAY, you can perform testing and debugging in advance of 
target hardware implementation as well as during periods of hardware 
unavailability. 


XRAY lets you examine or modify the value of program variables using the same 
high-level or assembly-level terms, definitions, and structures that were defined in 
the original source code. To display information, XRAY employs a window- 
oriented user interface that segregates debugging information into meaningful 
sections. You can even define your own windows. 


The debugger is interactive and gives you complete control of the program. It 
executes your program while allowing you to access variables, procedures, source 
line addresses and other program entities. 


XRAY’s powerful command language allows simple and complex breakpoint 

setting, single-stepping, and continuous variable monitoring. By simulating 

memory-mapped port I/O and interrupts, XRAY lets you redirect input and output 
CN to/from files, buffers, or viewports. In addition, a sophisticated macro facility 

allows complex command sequences to be associated with events such as the 
execution of a specific statement or the accessing of a specific data location. These 
features let you isolate errors and patch your source code. 


_ Data Flow 


Figure 1-1 shows the components of the Microtec Research ASM68K package and 
the way in which they communicate with each other and with the host computer 
system. 


Microtec Research provides compilers, assemblers, linkers, librarians, debuggers 
for simulation, and debuggers with monitor capabilities for the native environment 
as well as the cross-environment. Products contain numerous features which are 
needed for developing high-performance embedded applications. These products 
form the 68000 toolkit. 


Although embedded applications are becoming more common, many developers 
are not familiar with the unique problems caused by this approach. The following 
section describe the standard software development cycle and issues that should be 
considered when developing embedded applications. 


‘. 
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Software Development Cycle 


The standard software development cycle includes the following phases: 
requirements, design, coding, and testing. Once the product specifications have 
been defined and the design phase has completed, the software developer proceeds 
to implement this design in the coding phase and verifies that it works correctly in 
the testing phase. This section describes the coding and testing phases of a product 
and the various utilities used in these phases. 


Figure 1-2 shows a high-level block diagram of the coding and testing phases. You 
create your software program using an editor. Library routines are put into libraries 
or taken out of libraries using the librarian. The program is then compiled, 
assembled, and linked to produce executable code. The coding phase is now 
complete and the testing phase begins. If any errors are found in the coding or 
testing phase, you return to the editor to modify your program and continue through 
the cycle as before. 
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Native Environment ; — 


Normally, coding, testing, and the eventual execution of the program occurs on one 
machine. Any utility that is designed to operate on one type of machine and produce 
output for that type of machine is a native utility. For example, if you are on a 
machine and use a compiler that creates object code for that machine, that compiler 
is called a native compiler. 


assembly code 


Librarian 


executable code 


Debugger 


os pater ac 


Figure 1-2. Products Used In Coding and Testing Phases 
(Native Environment) 
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Intreduction Software Development Cycle 
Cross Environment 
As more computers were designed using different chips, software developers were 
“faced with the problem of developing software on one machine and executing this 
software on a different machine. Utilities that operate on one machine and generate 
code for a different type of machine are known as cross utilities. For example, if you 
are on a 68000 machine and use a compiler that creates 8086 object code, that 
compiler is called a cross-compiler. Your 68000 machine is referred to as the 
‘‘development’’ environment and the 8086 machine is referred to as the ‘‘target’’ 
environment, 


The products used in the coding and testing phases are shown in Figure 1-3. With 
the exception of the editor, all the other products (compiler, assembler, linker, 
librarian, and debugger) generate or read target machine code instead of 
development machine code. For example, if your development machine is 
68000-based and your target machine is 8086-based, follow the development steps 
below: 


e Create a program in a high-level language (e.g., C) on your development 
machine using a standard editor. 

e Generate 8086 object code or assembly code using an 8086 cross- 

compiler on your high-level source program. 
( \ * Assemble your 8086 assembly code using an 8086 cross-assembler. 

* Combine 8086 object code library routines by using an 8086 librarian. 

e Link your 8086 modules together to form an 8086 executable using an 
8086 linker. 

e Debug your 8086 executable using a monitor, simulator or emulator, 
while still residing on your 68000 development machine. 

¢ Download your program to the target 8086 machine for more tests once 
you have debugged your software. 


In a standard cross-environment, a target machine is similar to your development 
machine even though it is based on a different hardware architecture, Both 
machines have an operating system, terminals, disks, etc. 


A need for hardware products to perform specific functions led to embedded 
systems. An embedded application performs specific tasks and executes on a CPU 
located in the middle of some other type of hardware. Since your software is not 
located on a nonmal machine, embedded software development creates some unique 
problems. The next section describes the embedded software development cycle 
and some of the unique problems that occur. 
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Figure 1-3. Products Used in Coding and Testing Phases 
(Cross Environment) 
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Embedded Environment 


Software created for an embedded application is usually located in RAM and ROM 
within the hardware unit that it serves. This hardware unit may or may not have an 
operating system, display terminal, storage devices, etc. It may interface to a variety 
of peripherals. Restraints on space, weight, and speed may force the developer to 
deal with limited memory and real-time performance requirements. Figure 1-4 
illustrates the coding and testing phases for the embedded application. 
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Figure 1-4, Products Used In Coding and Testing Phases 
(Embedded Development) 
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Despite similarities to cross-environment applications, this new environment, the 
embedded environment, forces the developer to consider problems that do not occur 
in cross-environments or native environments: 


° 


no high-level operating system 

non-standard I/O 

interfaces to unique peripherals 

physical location of program in target machine 
initialization of program in target machine 

different file formats 

debugging capabilities 

downloading code to target machine’s RAM or ROM 


These problems, coupled with the difficulty of embedded testing, make embedded 
applications a challenging task. Often, the embedded hardware is not available until 
late in the development cycle and you are forced to develop your software by using 
simulators, or downloading your software to hardware test machines or emulators. 
Sets of tools that are designed for the embedded environment, such as the 68000 
toolkit, provide the flexibility and versatility required by this unique environment. 
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Introduction 


This chapter describes the syntax for invoking the assembler, linker, and object 
module librarian on a VAX host computer under the VMS operating system. 
Command line options and their syntax are described. Command line options 
contro] the generation of the output listing and object module, and turn assembler 
switches on and off. 


The operating system prompt used in the directions is a dollar sign ($). Your system 
may be configured with a different prompt. 


ASM68K Assembler 


The Microtec Research ASM68K Assembler converts assembly language programs 
to relocatable object code. Object modules are produced in IEEE-695 format. After 
assembly, object modules are combined by the linker. 


LNK68K Linker 


The Microtec Research LNK68K Linker allows multiple relocatable object 
modules to be combined into a single relocatable module that subsequently can be 
re-linked with other modules (i.e., incremental linking), The linker can also 
combine relocatable object modules into a single absolute object module in one of 
the following formats: 


e Motorola S-Record format 
e JEEE-695 format 
e Hewlett-Packard 64000 format (HP-OMF) 


The LNK68K Linker has some powerful features designed for embedded 
applications, which provide the capability to load your software at locations that 
match your unique hardware environment. You can specify: 

¢ where to load segments 

¢ order to load segments 

* size of segments to use 


If one or more of the linker input files is a library of object modules, the linker 
automatically loads all modules from the library that are referenced by the 
individually-named object modules. 
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LIB68K Librarian 


The Microtec Research LIB68K Object Module Librarian lets you maintain a 
collection of relocatable object modules that reside in one file. By using the 
librarian, you can format and organize library files that will subsequently be used 
by the linker. 


ASM68K Assembler 


The Microtec Research ASM68K Assembler produces object code that will be used 
later by the LNK68K Linker and LIB68K Librarian. 


Invocation Syntax 


This section describes the command line syntax needed to invoke the ASM68K 
Assembler. Abbreviations for options are shown in the Description section. After 
entering an abbreviation, any number of characters can be specified up to and 
including the option’s full spelling. 


Use parentheses to specify multiple settings for the same option. For example, 
APATH=(/dirl,/dir2) will search both directories, as specified. However, if you 
had entered /IPATH=dirl /IPATH=dir2, only the last parameter is used; the first 
directory is not searched. 


Options are case-insensitive and are separated by a slash (/). 
Syntax: 


A68K [ /DEFINE sym(=value]] [{ /FLAGS="flag list™ ] 
[ /HP | /NOHP ] [IPATHedir) { /LIst{@list_file] | /NOLIST } _ 
{ /oBgEcT[=object_file] | /NOOBJECT } 
[/VERSION] source_file 


Description: 


AG68K The invocation name of the assembler. 


DEFINE sym[=value] 
Defines the symbol sym at assembly time. The parameter 
value must be a constant. If value is not specified, sym is set 
tol. 


The value of sym will be overriden by the first SET directive 
applied to sym in the source file. No EQU directives can be 
applied to sym. 
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FLAGS="flag_ list" 


HP 
A 


IPATR@dir 


= List [=list_file] 


Nnou#P (default) 


NOLIST 


NOOBJECT 


@ 
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ASM68K Assembler 


Enables and disables the assembler control flags (see 
Table 2-2). This option may be specified before or after the 
source_file. 


Produces an HP 64000 compatible (HP-OMF) asmb_sym 
symbol file. The D flag is automatically set, placing local 
symbols in the output object module. The default file name 
is source_file.A. This option may be specified before or after 
the source_file. 


For more information on HP 64000 development support, 
see Appendix A. 


Specifies a path to be searched to locate files that are to be 
included using the INCLUDE directive. For more informa- 
tion on the INCLUDE directive, see Assembler Directives in 
the Microtec Research ASMO68K Reference Manual. 


The assembler first searches for INCLUDE files in the 
directory containing the assembler source program. It next 
searches the directory specified by dir. A maximum of four 
paths can be specified. 


Produces a listing output file with the file name indicated. 
This option may be specified before or after the source_file. 


By default, a listing file is produced with the name 
source_file.LIS. 


Does not produce an HP 64000 compatible (HP-OMF) 
asmb_sym file. This option may be specified before or after 
the source_file. 


For more information on HP 64000 development support, 
see Appendix A. 

Inhibits production of a listing file. This switch overrides 
OPT S directives in the assembler source file. This option 
may be specified before or after the source_file. 


Inhibits production of an output object module. This switch 
overrides OPT O directives in the assembler source file. 
This option may be specified before or after the source_file. 
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OBJECT [=object_file) 
Produces an output object module with the file name 
indicated. This option may be specified before or after the 


source_file. 
By default, an object file is produced with the name 
source_file OBJ. 
VERSION Displays the version number of ASM68K and then exits. 
source_file Specifies the assembler input file. The default file name 


extension is .SRC. 
If you do not specify options, the following defaults will be used: 


/NOHP 
/uIst=source_file .L1s 
/OBJECT=source_file .OBT 


Refer to Table 2-2 for the default flags that will be used. 


File Name Defaults 


assembler produces them by default. The assembler uses the source file name as the 


Specification of the object file and list file are optional. If they are not specified, the C) 
root file name and appends the default extensions listed in Table 2-1. 


Table 2-1. VMS Default Assembler File Name Extensions 


File Extension 


HP 64000 asmb_sym file A 
Listing file -LIS 
Object file OBJ 


Source file 


File names can include some or all of the following specifications: 


Node name (current default assumed) 
Device name (current default assumed) 
Directory (current default assumed) 
File name 

Extension 

Version number 
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Command Line Flags 


Flags entered on the command line enable and disable internal assembly control 
switches. If you use a flag, the corresponding switch is enabled. Assembler 
command line flags for flag list in the FLAGS="flag_list" option are listed in 
Table 2-2. 


Abbreviations for the flags are shown. After entering an abbreviation, any number 
of.characters can be specified up to the flag’s full spelling. Parentheses, when 
shown, are required. Some flags can be negated by preceding the flag with the word 
NO or aminus sign (-). Multiple flags must be separated with commas and enclosed 
in double quotes. Examples of how to specify multiple flags can be found in the 
section titled Assembler Invocation Examples. 


You can obtain more information about the flags in the description of the OPT 
directive in the Microtec Research ASM68K Reference Manual. Flags entered on 
the command line have the effect of inserting an OPT command at the beginning 
of the source file. However, flags on the command line do not override other OPT 
directives in the source file. 


Table 2-2. VMS Assembler Command Line Flags 


Flag Meaning (positive form) 


ABSPCADD When this flag is set, an absolute expression in conjunc- 
tion with the mnemonic PC (i.e., 5(PC)) refers to an 
absolute address accessed through PC relative mode 
rather than to a relative displacement to the current pro- 
gram counter. 


For more information, refer to Assembler Syntax for Ef- 
fective Address Fields in Chapter 4, Addressing Modes, 
of your ASM68K Reference Manual. 

(default: ABSPCADD) 


Forces forward references in relative branch instructions 
(Bcc, BRA, BSR) to use the short form of the instruction 
(8-bit displacement). BRB is legal only in 68020 mode. 

(default: NOBRB) 


Forces forward references in relative branch instructions 
(Bcc, BRA, BSR) to use the long address (32 bits). If 
OPT OLD is in effect in conjunction with the BRL flag, 
the longer form is used. This flag only applies to 68020 
and 68030 processors. 

(default: NOBRL) 
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Table 2-2. VMS Assembler Command Line Flags {cont.) 
Flag Meaning (positive form) 


Forces forward references in relative branch instructions 
(Bcc, BRA, BSR) to use the short form of the instruction 
(8-bit displacement). 

(default: NOBRS) 


Forces 16-bit displacements to always be used in relative 
branch instructions (Bcc, BRA, BSR) that have forward 
references. 

(default: BRW) 


Retains case-sensitivity of symbols. For example, abc 
and ABC are treated as different symbols. 
(default: CASE) 


Lists all lines of object code that are generated by the DC 
directive. The NOCEX flag only lists the first line of a 
DC directive. 

(default: CEX) 


Lists instructions that are not assembled due to condi- 
tional assembly statements. 
(default: CL) 


Lists the cross-reference table on the output listing. This 
option overrides the symbol table output option, T. 
If both T and CRE are used, a cross-reference table is 
generated. 

(default: NOCRE) 


Places local symbols in the output object module. This 
flag is automatically set if you generate an asmb_sym 
file by using the HP option. 

(default: NOD) 


Lists lines with errors on your terminal as well as on the 
output listing. 
(default: E) 


{cont.) 
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Table 2-2. VMS Assembler Command Line Flags ({cont.) 


Flag Meaning (positive form) 


FRL Forces instructions that contain a forward reference to an 
absolute (non-relocatable) address to use a 32-bit address 
instead of a 16-bit address. 

(default: 32-bit address or FRL) 


Forces instructions that contain a forward reference toan . 
absolute (non-relocatable) address to use a 16-bit address 
instead of a 32-bit address. 

(default: NOFRS) 


G Lists assembler-generated symbols in the symbol or 
cross-reference table. If D is also specified, these sym- 
bols are included in the object module as well. 

(default: NOG) 


LLEN=n Sets the length of the line on the source listing to be n col- 
umns long, The n can be a number between 37 and 1120, 
inclusive, 

(default: LLEN=132) 


MC Prints macro calls on the program listing. 
(default: MC) 


MD Prints macro definitions on the program listing. 
(default: MD) 


Lists macro and structured control directive expansions 
on the program listing. 

(default: MEX) 

NEST=n Sets n nesting levels for macros. The maximum number 


of nesting levels allowed is 100. 
(default: NEST=100) 


oO Produces the output object module. 
(default: O) 
OLD Forces the assembler to generate 16-bit displacements 


for Bcc instructions when OPT BRL or OPT -B are 
specified, or when explicit .L qualifiers are used in 
68020 mode. This is useful when migrating 68000 pro- 
grams to the 68020 microprocessor. 

(default: OLD) 


(cont.} 
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Tabie 2-2. VMS Assembler Command LIne Flags (cont.) 


Flag Meaning (positive form) 


OP=n Resets the maximum number of optimization loops that 
the assembler will perform if the OPNOP flag is set. The 
assembler will discontinue looping if there is a pass in 
which no optimization occurs. 

(default: OP=3) 


Removes for optimization purposes any NOPs that have 
been generated by the assembler because of forward ref- 
erences. The assembler will often assume the worst case 
in determining the size of forward-referenced variables 
and will reserve the maximum space (usually 32 bits) for 
them. During the second pass of the assembler, NOPs 
will be generated if the operand represented by the vari- 
able can be used in an instruction format that is more 
compact than the size reserved during the first pass. 

(default: NOOPNOP) 


Specifies a set of compatible processors and coproces- 
sors. The type can be 68000, 68008, 68010, CPU32, 
68020, 68030, or 68040. 


The cotype can be 68881 (used for 68881 or 68882) or 
68851 (compatible with all types except 68030 and 
68040). 

(default: 68000/68881) 


P=nype[/cotype]... 


Example: 
P=68020/68881/68851 


It is an error to specify an incompatible set of processors, 
such as P=68030/68851. 


Uses the program counter relative addressing mode on 
backward references within an absolute (ORG) section 
whenever possible. This flag is only applied to instruc- 
tions where the relative addressing mode is legal and the 
displacement from the program counter fits within the 
16-bit field provided. 

(default: NOPCO) 


(cont.) 
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Table 2-2. VMS Assembler Command Line Flags (cont.) 


Flag Meaning (positive form) 


Uses program counter relative addressing mode on refer- 
ences from a relocatable section to the same section 
within the current module for all instructions for which 
this is a legal address mode. PCR differs from PCS in 
that PCS applies to all relocatable sections within this 
module and assumes you know the boundaries. PCR will 
only affect intrasection expressions within the current 
module (expressions for which the assembler has enough 
information to generate the correct relative offset). 
(default: PCR) 


Uses program counter relative addressing mode on back- 
ward references from a relocatable section to the same 
section or to a different relocatable section. This address- 
ing mode will be used on all instructions for which the 
program counter relative addressing mode is legal. 


O (default: NOPCS) 

= Changes the MOVE, ADD, and SUB instructions to the 
more efficient MOVEQ, ADDQ, and SUBQ instruc- 
tions. 


Before the Change . After the Change 


MOVE.L #data, Dn MOVEQ #data, Dn 
ADD #data, ea ADDQ' #data, ea 
SUB #data, ea SUBQ #data, ea 
where: 


data Legal values are -128 to 127 for MOVE and 
MOVEQ instructions, 


Legal values are 1 to 8 for ADD, ADDQ, 
SUB, and SUBQ instructions. 

ea Effective address. 

n Number of data register. 


For more information on these instructions, see a Motor- 
ola Microprocessor User's Manual. 
(default: QUICK) 


CO (cont) 
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Table 2-2. VMS Assembler Command Line Flags (cont.) 


Flag Meaning (positive form) 


REL32 Forces the assembler to default to 32-bit base and outer 
displacements when the address range is 32 bits long. 
This flag can be turned on and off at any time in the pro- 
gram. It will only be effective if the processor type is set 
to 68020 or 68030. 


Addressing modes which first appeared with the 68020: 


((bd,An,Xn) ([bd,An,Xn],0d) ((bd,An],Xn,od) 
(bd,PC,Xn) ([bd,PC,Xn],0d) ({bd,PC),Xn,od)) 


defaulted the size of the outer and base displacements to 
word for forward references, external references, com- 
plex expressions, and relocatable expressions. While the 
code produced was smaller, you had to‘always size cast 
displacement expressions if you had a processor that ac- 
cessed a full 32-bit address range (68020/30). The 
REL3z2 flag lets you change the default to 32 bits without 
size casting displacement expressions. 

(default = NOREL32) 


Lists the source text on the output listing, 
(default = S) 


Lists the symbol table on the output listing. 
(default = T) 


Prints wamings during the assembly. 
(default = W) 


Lists the cross-reference table on the output listing. This 
option overrides the symbol table output option, T. If both 
T and X are used, a cross-reference table is generated. 

(default = NOX) 
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Invocation Examples 


The examples in this section show how to invoke the assembler and specify 
multiple flags on the command line. 


Example: 


$ A68K MOD68 


The source file mop68.sRc is assembled, producing the default output files 
MOD68.LIS (listing file) and MOD68.OB J(output object module). 


Example: 

$ A68K/FLAGS="CRE,G" MULTD 
The source file muttp.src is assembled, producing the output listing 
MULTD.LIS. The output object module is named MULTD.OBJ. The cre and ¢ 


options force a cross-reference table to be printed on the output listing and 
assembler-generated symbols to be included in the cross-reference table. 


Example: 


$ AG68K/FLAGS="-C,P=68020"/NOLIST/OBJECT=TEMP DIVD 


The source file pivp.sRc is assembled, producing the output object module 
TEMP .OBJ, Generation of an output listing is inhibited by the NoLIsT option. The - 
c option prevents the listing after the first line of all lines of object code that are 
generated by the DC directive. The P=68020 option lets code be assembled for the 
68020 or equivalent microprocessor. 


Example: 
$ A68K/HP MOD1/FLAGS="P=68020, x" 


The source file mop1.src is assembled, producing the output listing MOD1.LIS. 
The relocatable object module produced is MOD1.OBJ. 


The /aP option causes the asmb_sym file MOD1.A to be produced as well. The 
assembler automatically sets the D flag, which includes local symbols in the output 
object module. The x flag causes the output listing to include the cross-reference 
table. The P=68020 flag defines assembled code for the 68020 microprocessor. 
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LNK68K Linker 


There are two ways to invoke the linker: using a command file and or using the 
command line (with an optional command file). Using these methods, you can 
produce absolute or relocatable output suitable for incremental linking. However, 
you should remember that if you use the incremental link option, which produces a 
relocatable object module, the only linker commands that can be entered are LOAD 
commands. 


The next section describes the invocation syntax for the LNK68K Linker. 
Subsequent sections provide examples of different invocation methods. 


Invocation Syntax 
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Abbreviations for options are also shown. After entering the abbreviation, any 
number of characters can be specified up to and including the option’s full spelling. 


Use parentheses to specify multiple settings for the same option. For example, 
/COMMAND=(cemd1,cmd2) will execute two linker commands, as specified. 
However, if you had entered /COMMAND=cmd1 /COMMAND=cmdz, only the 
last parameter is used; the first command is not executed. 


Options are case-insensitive and separated by a slash (/). 


Syntax: 


L68K [ /ABSOLUTE(=a@bsolute_file] | /NOABSOLOUTE } 
{ /COMMAND=comunand ] ( /FORMAT=format ] 
{ /aP | /NOHP ] [ /LIBRARY=library | 
{ /MaAP=map_file | /NoMaP ] [ /oBJECT=relocatable_file | 
[ /REFERENCE=amMe] [/VERSION] 
{ /OPpTION command_file | object_file{,object_file)...} 


Description: 
L68K Invokes the linker. 


ABSOLUTE [=absolute_file) 

aBs [=absolute_file} 
Produces an absolute object file with the file name indicated. 
If not specified, the file name defaults to the same name as 
the command file with an .ABS extension. (default) 


NOABS Inhibits generation of an absolute object module. 
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COMMAND=command ; 
Specifies a linker command. This command behaves as 
though it is placed at the top of the command_file. Multiple 
- linker commands can be specified. 


Note 


The /FLAGS="flag_list" option, which was supported in 


previous versions of the linker, will not be supported in future 
releases. For information about this option, refer to Appendix H, 
Not Supported in Future Releases. 


FORMAT=format Specifies the format of the file created by the linker. Legal 
values for format are the same as those for the linker 
FORMAT command and include: 


HP HP-OMF format 
IEEE IEEE-695 format (default) 
INCREMENTAL 

TEEE-695 format (incremental linking) 


{ ) Ss Motorola S-Record 


NOABS No object file is produced; however, 
internal processing is performed and a 
map file will be produced if requested. 


HP Produces HP 64000-compatible object modules (HP-OMF) 
and link_sym files. Sets LISTABS PUBLICS and 
LISTABS INTERNALS. 


The default file extension for the absolute file generated is 
-X. The link sym file is given the source file root name with 
a .L extension. 


For more information on this option, see the FORMAT HP 
linker command in the Microtec Research ASM68K 
Reference Manual. For more information on HP 64000 
development support, see Appendix A. 


NOP Does not produce an HP 64000 compatible (HP-OMF) 
asmb_syim file. This option may be specified before or after 
the source_file. 


For more information on HP 64000 development support, 
see Appendix A. 
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LIBRARY=library 


MAP [~map_file] 
M{=map_file) 


NOMAP 


Specifies a library to be searched after all object files have 
been loaded. 


Produces a link map with the file name indicated. The default 
file name is the name of the source file with the extension 
-MAP. : 

(default: source_file. MAP) 


Does not produce an output link map. 


oBgEct [=relocatable_file) 
oBd [=relocatable_file] 


Produces a relocatable object file that can be linked with 
other object modules. The file name must be specified in 
batch mode. The default file name extension is .OBJ. 


This option can be used in place of /ABSOLUTE to 
incrementally link object module files. Since an absolute 
link is not performed, unresolved external references to other 
modules can exist in the resulting relocatable object module. 


For more information on this option, see the FORMAT 
INCREMENT linker command in the Microtec Research 
ASMO68K Reference Manual. 


OPTION command_file 


oP command _file 


REFERENCE=ame 


VERSION 


object_file 


Indicates use of a batch command file. The command file 
name extension defaults to .OPT. : 


Creates an external reference called name for the linker to 
resolve. For more information on this option, see the 
EXTERN linker command in the Microtec Research 
ASMO68K Reference Manual. 


Displays version number of LNK68K and then exits. 


Specifies the source object file(s). The .OBJ file name 
extension is assumed, 
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If you do not specify options, the following defaults will be used: 


/ABSOLUTEsobject_file ABS 
/MaPeobject_file .MAP 
/NOHP 


Refer to the Invocation Examples section for examples of the interactive and non- 
interactive linker invocation modes. 


It is illegal to specify certain combinations of command line options. For example, 
it is illegal to specify both ABS and OBJ, or OBJ and HP. The linker displays an 
appropriate error message if an illegal combination is specified. 


File Name Defaults 


Specification of the map and output object module file names is optional. If they are 
not specified, the linker produces them by default. If an output file name is not 
specified, the linker uses either the command file name (command_file.extension), 
if present, or the first input object file name (object_file.extension) as the root file 
name for generated files. If file name extensions (input or output) are not specified, 
the default extensions listed in Table 2-3 are assumed. 


Table 2-3. VMS Default Linker File Name Extensions 


CY Extension 


Absolute output object file 
Output HP-OMF link_sym file 
Output link map file 


Input object file 

Relocatable output object file 

Input command file 

Output HP-OMF absolute object file 


The linker uses the current defaults if you do not specify a node, device, or 
directory. 


() 
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Invocation Examples O 


The following examples illustrate various methods of invoking and using the linker. 
Exampies shown include multiple flags entered on the command line and 


specifying incremental linking. 
Invoking LNK68K with a Command File 


You can enter linker commands in batch mode through the use of a command file. 
Any fatal error in the command file prevents the link from being completed. 
However, all commands in the file are processed and checked for errors. 


Example: 
$ L68K/OPTION CMD/MAP=MY .MAP 


The linker reads the command file cmp. opt and produces a link map called my . ap. 
The absolute object file CMD.ABS is generated in IEEE-695 format. 


Example: 


$ L68K/NOABS/OPTION LMULT/REFERENCE=TEST1 


LMULT.MAP. Generation of an object module is inhibited by the /NoaBs option. 
It may be useful to inhibit generation of an object module in order to check for load 
errors. 


The linker reads the command file Luu.t.opt and produces a link map called € 


The external symbol TeEsT1 is defined which the linker tries to resolve. 
Example: 
$ L68K/OPTION/HP .LMOD1.CMD 


The command file LMop1.cum is read, and the link map produced is named 
LMOD1.MAP. 


The LISTABS PUBLICS and LISTABS INTERNALS linker commands are 
automatically set by the use of the /aP option, so the linker includes external and 

. local symbols in the output file. The /ae option generates the absolute object 
module, LMOD1.X in HP-OMF format, and the HP link_sym file, LMOD1.L. 
External and local symbols are placed in the output object module. 


UO 
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Example: 


$ L68K/HP/OPT LFILE 


The command file tF1Le.opr is read, and the link map produced is named 
LFILE.MAP. If an extension had been specified with the command file name, then 
that command file with the specified extension would have been read. The /HP 
option causes generation of the absolute object module LFILE.X in HP-OMF 
format and the HP link_sym file LFILE.L. 


The LISTABS PUBLICS and LISTABS INTERNALS linker commands, which 
include both local and external symbols in the output object module, are 
automatically set by the linker. 

Invoking LNK68K Without a Command File 


You can enter the names of object modules that will be linked together on the 
command line. 


Example: 
$ L68K/OBJECT=LORP/NOMAP DORP, FORP,SORP 


The object modules Dorr .oBJ, FORP.OBJ, and SORP .OBJ are incrementally linked 
forming the relocatable object module output file LORP.OBJ. Output of a link map 
is inhibited by use of the /NomaP option. 
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LIB68K Librarian 


The Microtec Research LIB68K. Object Module Librarian builds and maintains 
program libraries. Libraries are collections of relocatable object modules residing 


in a single file. 


Invocation Syntax 
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The command line can be continued on the next line if a minus sign (-) is the last 
character on the line to be continued. 


Only certain library functions can be specified on the command line: ADDMOD, 
DELETE, REPLACE, EXTRACT, and FULLDIR. These librarian commands 
can be entered in any order, but the librarian processes the commands in the order 
specified above. Multiple object modules and files must be enclosed in double 
quotes. 


Syntax: 


B68K [ /OPTION command file | 
library file {/FULLDIR[-library_listfile)] 
(/ADDMOD="file_name"{, "file name"™]...] 
[/DELETE="module_name"{, "module_name"]...] 
(/EXTRACT="*module_name® (,"module_name"]...} 
[/REPLACE="file_name" (, "file_name"]...1] 
{/ourpurTelist_ file] [/VERSION)} 


Description: 


B68K Invokes the librarian. 


OPTION command_file 

oP command_file 
Indicates use of a command file, which contains linker 
commands. The command file extension is assumed to 
be .OPT unless otherwise specified. In the interactive 
mode, the command file is the terminal (TT:). 


library_file Specifies the library file to be read or written. The default 
file extension is .LIB. 


FULLDIR[~library_lisifile} 
Displays the contents of the library named on the 
command line (Jibrary_file). If the file library_listfile is 
not specified, the library information is written to the 
terminal. 
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aADpMop="file_name"{, ‘file name")... . 
Adds the module(s) in the named files to an existing 
library. 
DELETE="module_name"[,"module_name")... 
Deletes the named module(s) from the library. 


EXTRACT="module_name"[, "module_name"]... 


Extracts the named module(s) from the library and places 
them in files that have the same module name and the 
extension .OBJ. The modules are not deleted from the 
library. 


REPLACE="file_name"[, "file_name™]... 
Replaces the module(s) in the library with modules 
having the same name from the specified file(s). 


ourputs=list_file Specifies the output listing file. The default file extension 
is .LIS. 


Ps VERSION Displays the version number of LIB68K and then exits. 


(\ The output will be displayed on your terminal, unless you have specified the 
ouTPut=list file option. 


File Name Defaults 


A summary of librarian file name default extensions is listed in Table 24. 


Tabie 2-4. VMS Default Librarian Fille Name Extensions 


File Extension 


Library file -LIB 


Listing file LIS 
Relocatable object module -OBJ 
Input command file .OPT 
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Invocation Examples 


There are three ways to invoke the LIB68K Librarian: interactive mode, command 
line mode, and command file mode. Examples of these methods are described 
below. : 


Invoking LIB68K Interactively 


You can enter librarian commands interactively from the terminal. A help facility 
is available by typing h or help. When an illegal command is entered, the librarian 
displays an error message and provides an opportunity to re-enter the command. In 
this interactive mode, most librarian command errors are not fatal. Multiple object 
modules or files must be enclosed within double quotes. 


Example: 
$ B68K 


The librarian displays a prompt (LIB68K>) for interactive input. 


Invoking LIB68K from the Command Line 


You can enter librarian commands on the command line. This method can only be 
used to modify an existing library. A new library cannot be created using this 
method. 


Only certain library functions can be specified using this method; these are 
ADDMOD, DELETE, REPLACE, EXTRACT, and FULLDIR. These librarian 
commands can be entered in any order, but the librarian collects the commands and 
processes them in a fixed order: ADDMOD, DELETE, REPLACE, EXTRACT, 
and FULLDIR. FULLDIR implies DIRECTORY. 


Example: 


$ B68K EXLIB.LIB/REPLACE="SYM1.OBJ,SYM2.OBJ" - 
$ /ADDMOD="MOD1.OBJ,MOD2.0BJ,MOD3.OBU"° 


The REPLACE option replaces modules sym1.oBJ and sym2.oBa in the library file 
EXLIB.LIB. The ADpMop option adds modules Mop1 . oBU, MOD2 . OBJ, and MOD3. OBJ 
to the library ExL1B.LIB. The librarian will execute the ADDMop command, then the 
REPLACE command. These commands can be specified on the command line in any 
order. The line continuation character, (-), continues the command-line entry on a 
second line. 
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. Invoking LIBG8K with a Command File 
You can read librarian commands from a command file in batch mode. The 
commands are read in the exact order in which they are specified. If an error is 
found, commands read after the first error is found are processed, checked for 
etrors, and executed if possible. If a library file is specified, it is not generated if an 
etror is encountered. 


Example: 
$ B68K /OPTION COMMAND.OPT /OUTPUT=PRINTOUT 


The library commands are all contained in the command file commanp.ort. The 
output listing will be written to the file PRINTOUT. LIS. : 


VMS Return Codes 


The assembler, linker, and librarian pass a return code to VMS upon completion of 
program execution. The return code indicates whether the program executed 
properly or not. The return codes are: 


O Warning. 
CN The program ran to completion, but there were user-created warnings. 
1 No Error. 


The program ran to completion with no user errors. 


2 Execution Error. 
The program ran to completion, but there were user-created assembler, 
linker, or librarian errors. 

4 = Fatal Error. 


The program did not run to completion due to a system problem. For 
example, the program was not allocated the required amount of disk space, 
or a file read/write error occurred. 
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Introduction 


This chapter describes the syntax for invoking the assembler, linker, and object 
module librarian for use on all UNIX systems, UNIX-like systems, PC-DOS 
systems, and MS-DOS systems. 


Command line options and their syntax are described. Command line options 
control the generation of the output listing and object module, and turn assembler 
switches on and off. 


The operating system prompt used in the directions is a percent sign (%). Your 
system may be configured with a different prompt. 


The line continuation character, the backslash (\), is used to continue the 
command-line entry on the next line for UNIX systems only. 


ASM68K Assembler 


Coy The Microtec Research ASM68K Assembler converts assembly language programs 
to relocatable object code. Object modules are produced in IEEE-695 format. After 
assembly, object modules are combined by the linker. 


LNK68K Linker 


The Microtec Research LNK68K Linker allows multiple relocatable object 
modules to be combined into a single relocatable module that subsequently can be 
re-linked with other modules (i.e., incremental linking). The linker can also 
combine relocatable object modules into a single absolute object module in one of 
the following formats: 


¢ Motorola S-Record format 
e YEEE-695 format 
¢ Hewlett-Packard 64000 format (HP-OMF) 


The LNK68K Linker has some powerful features designed for embedded 


applications, which provide the capability to load your software at locations that 
match your unique hardware environment. You can specify: 


¢ where to load sections 
¢ order to load sections 
e size of sections to use 
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If one or more of the linker input files is a library of object modules, the linker 
automatically loads all modules from the library that are referenced by the 
individually-named object modules. 

LIB68K Librarian 


The Microtec Research LIB68K Object Module Librarian lets you maintain a 
collection of relocatable object modules that reside in one file. By using the 
librarian, you can format and organize library files that will subsequently be used 
by the linker. 


ASM68K Assembler 


The Microtec Research ASM68K Assembler produces object code that will be used 
later by the LNK68K Linker and LIB68K Librarian. 


Environment Variables 


This section describes environment variables that affect ASM68K Assembler 
operation. Environment variables must be set before invoking the assembler. 


TMP (DOS only) 
The TMP environment variable specifies a directory path for temporary files: 


SET TMP=my_tmpdir 


invocation Syntax 


This section describes the command line syntax needed to invoke the ASM68K 
Assembler. Abbreviations for options are shown in the Description section. After 
entering an abbreviation, any number of characters can be specified up to and 
including the option’s full spelling. 


Syntax: 


& asm68k [-b] [-Dsym{[=value}] {-£ flag list] [-h] [-8 asmb_symfile] 
[-1 pathname...) [-1 | -L] (-o object_file] [-v] source_file 


Description: i 
asm68k The invocation name of the assembler. 
-b Stores intermediate information in a temporary file (instead 


of virtual memory) between pass 1 and 2 of the assembler. 
This option is valid for UNIX systems only; DOS systems 
always use a temporary file. 
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-D sym[=value] 


-£ flag _list 


ch 


-H asmb_symfile 


-I pathname 


o-1 
“1 


-o object_file 


Microtec Research, Inc. 


Defines the symbol sym at assembly time. The parameter 
value must be a constant. If value is not specified, sym is set 
to 1. 


The value of sym will be overridden by the first SET 
directive applied to sym in the source file. No EQU 
directives can be applied to sym. 


Enables and disables the internal assembler control flags (see 
Table 3-2). 


Generates an HP 64000 compatible (HP-OMF) asmb_sym 
symbol file. The d flag is automatically set, placing local 
symbols in the output object module. The default file name 
is source_file.A. 


For more information on HP 64000 development support, 
see Appendix A. 


Generates an HP 64000 compatible (HP-OMF) asmb_sym 
symbol file with the name asmb_symfile. The d flag is 
automatically set, placing local symbols in the output object 
module. 


For more information on HP 64000 development support, 
see Appendix A. 


Specifies a path to be searched to locate files that are to be 
included using the INCLUDE directive. For more informa- 
tion on the INCLUDE directive, see Assembler Directives in 
the Microtec Research ASM68K Reference Manual. 


The assembler first searches for include files in the directory 
containing the assembler source program. It next searches 
the directory specified by pathname. A maximum of four 
paths can be specified. For instance, -1path! -Ipath2 and 
so on. 


Produces a listing file which is written to the standard output 
device. The standard output can be redirected to a file. 


Overrides the default object module file name with the 
specified file name. The default file name is source_file.o 
(UNIX) or source_file.obj (DOS). You must use this option 
if you redirect the source file. 
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ee ee eal Site. 3 
-v Displays the version number of ASM68K then exits. ‘o) 
source_file Specifies the assembler source file name. The default file 


name extension is .s (UNIX) or .src (DOS). The source file 
must be the last entry on the command line, excluding 
redirected standard output listings. 


If you do not specify options, the following defaults will be used: 
source_file.s (UNIX) or source_file.src (DOS) or the standard input device 
no listing file 
source_file.o (UNIX) or source_file.obj (DOS) in TEEE-695 format 

Refer to Table 3-2 for the default flags that will be used. 


Error messages as a result of erroneous command line entries are written to the 
standard error output device. 


Fite Name Defaults 


If no source file is named, the source is read from the standard input device. An 

output object module is produced by default. The assembler uses the source file 

name as the root file name and appends the default file name extensions listed in ( a } 
Table 3-1. 


Table 3-1. UNIX/DOS Default Assembler File Name Extensions 


Assembler source file 


HP 64000 asmb_sym file 
Relocatable object file 


File names can include the following full file specification information: 


Path name (current default assumed) 
File name (current default assumed) 
Extension (current default assumed) 


QO 
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Command Line Flags 


Flags specified on the command line have the effect of inserting an assembler 
control at the beginning of the source file. 


Assembler command line flags for flag list in the -f flag_list option are listed in 
Table 3-2. Abbreviations for the flags are also shown. After entering an 
abbreviation, any number of characters can be specified up to the flag’s full 
spelling. Some flags may be negated by using the prefix no, as shown in the table. 


Multiple items in the list are separated from each other by a space, slash, or comma. 
If multiple flags or flags with parenthesized text are specified, the flag list should 
be enclosed within double quotes. Parentheses, when shown, are required. If 
conflicting flags are specified, the first flag overrides the second one. 


More information about the flags can be obtained in the description of the OPT 
directive in the Microtec Research ASM68K Reference Manual. Flags entered on 
the command line have the effect of inserting an OPT directive at the beginning of 
the source file. However, flags on the command line do not override other OPT 
directives in the source file. 


~ , Table 3-2. UNIX/DOS Assembler Command Line Flags 


Flag Meaning (positive form) 


When this flag is set, an absolute expression in 
conjunction with the mnemonic PC (i.e., 5(PC)) refers to 
an absolute address accessed through PC relative mode 
rather than to a relative displacement to the current 


program counter. 


For more information, refer to Assembler Syntax for 
Effective Address Fields im Chapter 4, Addressing 


Modes, of your ASM68K Reference Manual. 
(default: abspcadd) 


Forces forward references in relative branch instructions 
(Bcc, BRA, BSR) to use the short form of the instruction 
(8-bit displacement). The brb flag is legal only in 68020 
mode. 

(default: nobrb) 


(cont.} 


Cc) 
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Table 3-2. UNIX/DOS Assembler Command LIne Flags (cont.) 


Flag Meaning (positive form) 


bri Forces forward references in relative branch instructions 
(Bcc, BRA; BSR) to use the long address (32 bits). If | 
OPT OLD is in effect in conjunction with the brl flag, 
the longer form is used. This flag only applies to 68020 
and 68030 processors. 

(default: nobrl) 


Forces forward references in relative branch instructions 
(Bec, BRA, BSR) to use the short form of the instruction 
(8-bit displacement). 

(default: nobrs) 


brw Forces 16-bit displacements to always be used in relative 
branch instructions (Bec, BRA, BSR) that have forward 
references. 

(default: brw) 


Retains case-sensitivity of symbols. For example, abc 
and ABC are treated as different symbols. 
(default: case) 


Lists all lines of object code that are generated by the DC 
directive. The nocex flag only lists the first line of a DC 
directive. 

(default: cex) 


Lists instructions that are not assembled due to 
conditional assembly statements. 
(default: cl) 


cre Lists the cross-reference table on the output listing. This 
option overrides the symbol table output option, t. If both 
t and cre are used, a cross-reference table is generated. 
(default: nocre) 


d Places local symbols in the output object module. This 
flag is automatically set if you generate an asmb_sym file 
by using the -H or -h option. 

(default: nod) 


(cont.) 
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Table 3-2. UNIX/DOS Assembier Command Line Flags (cont.) 


Flag Meaning (positive form) 


e Lists lines with errors on the standard error output device, 
as well as on the output listing. 
(default: e) 


Forces instructions that contain a forward reference to an 
absolute (non-relocatabie) address to use a 32-bit address 
instead of a 16-bit address. 

(default: 32-bit address or fr]) 


Forces instructions that contain a forward reference to an 
absolute (non-relocatable) address to use a 16-bit address 
instead of a 32-bit address. 

(default: nofrs) 


Lists assembler-generated symbols in the symbol or cross- 
reference table. If d is also specified, these symbols are 
included in the object module as well. 

(default: nog) 


Sets the length of the line on the source listing to be n 
columns long. The can be a number between 37 and 
1120, inclusive. 

(default: Iten=132) 


Prints macro calls on the program listing. 
(default: me) 


Prints macro definitions an the program listing. 
(default: md) 


Lists macro and structured control directive expansions on 
the program listing, 
(default: mex) 


Sets n nesting levels for macros. The maximum number of 
nesting levels allowed is 100 (UNIX) or 8 (DOS). 
(default: nest=100 (UNTX) or nest =8 (DOS)) 


(cont.) 
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‘Table 3-2. UNIX/DOS Assembler Command Line Flags (cont.) 


Flag Meaning (positive form) 


° Produces the output object module. 
_ (default: 0) 


old Forces the assembler to generate 16-bit displacements for 
Bcc instructions when OPT BRL or OPT -B are specified, 
or when explicit .L qualifiers are used in 68020 mode. This 
is useful when migrating 68000 programs to the 68020 
microprocessor. 
(default: old) 


op=n Resets the maximum number of optimization loops that the 
assembler will perform if the opnop flag is set. The 
assembler will discontinue looping if there is a pass in 
which no optimization occurs. 

(default: op=3) 


opnop Removes for optimization purposes any NOPs that have 
been generated by the assembler because of forward 
references. The assembler will often assume the worst case 
in determining the size of forward-referenced variables 
and will reserve the maximum space (usually 32 bits) for 
them. During the second pass of the assembler, NOPs will 
be generated if the operand represented by the variable can 
be used in an instruction format that is more compact than 
the size reserved during the first pass. 

(default: noopnop) 


p=hypel[/cotypel... 
Specifies a set of compatible processors and coprocessors. 
The type can be 68000, 68008, 68010, CPU32, 68020, 
68030, or 68040. 


The cotype can be 68881 (used for 68881 or 68882) or 
68851 (compatible with all rypes except 68030 and 68040). 
(default: 68000/68881) 


Example: 
p=68020/68881/68851 


It is an error to specify an incompatible set of processors, 
such as p=68030/68851. 


(cont) 
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Table 3-2. UNIX/DOS Assembfer Command LIne Flags (cont.) 
Flag Meaning (positive form) 


Uses the program counter relative addressing mode on 
backward references within an absolute (ORG) section 
whenever possible. This flag is only applied to instructions 
where the relative addressing mode is legal and the 
displacement from the program counter fits within the 16- 
bit field provided. 

(default: nopco) 


The program counter relative addressing mode will be 
used on references from a relocatable section to the same 
section within the current module for all instructions for 
which this is a legal addressing mode. 


The per flag differs from pcs in that pcs applies to all 

relocatable sections within this module and assumes you 

know the boundaries. The pcr flag will only affect 

intrasection expressions within the current module 
C) (expressions for which the assembler has enough 

information to generate the correct relative offset). 
(default: per) 


Uses the program counter relative addressing mode on 
backward references from a relocatable section to the same 

. section or to a different relocatable section. This address- 
ing mode will be used for all instructions for which the 
program counter relative addressing mode is legal. 
(default: nopes) 


CY 
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Tabie 3-2. UNIX/DOS Assembler Command Line Flags (cont.} 


Flag Meaning (positive form) 


quick Changes the MOVE, ADD, and SUB instructions to the 
more efficient MOVEQ, ADDQ, and SUBQ instructions. 


Before the Change After the Change 


MOVE.L #data, Dn MOVEQ #data, Dn 
ADD #data, ea ADDQ_ #data, ea 
SUB #data, ea SUBQ- #data, ea 


where: 
data Legal values are -128 to 127 for MOVE and 
MOVEQ instructions. 
Legal values are 1 to 8 for ADD, ADDQ, 
SUB, and SUBQ instructions. 
ea Effective address. 
n Number of data register. 


For more information on these instructions, see a Motorola 
Microprocessor User's Manual. 
(default: quick) 


Forces the assembler to default to 32-bit base and outer 
displacements when the address range is 32 bits long. This 
flag can be turned on and off at any time in the program. It 
will only be effective if the processor type is set to 68020 
or 68030. 


Addressing modes which first appeared with the 68020: 


((bd,An,Xn) ([bd,An,Xn],od) ((bd,An],Xn,od) 
(bd,PC,Xn) ([bd,PC,Xn},od) ([bd,PC],Xn,od)) 


defaulted the size of the outer and base displacements to 
word for forward references, external references, complex 
expressions, and relocatable expressions. While the code 
produced was smaller, you had to always size cast dis- 
placement expressions if you had a processor that accessed 
a full 32-bit address range (68020/30). The rel32 flag lets 
you change the default to 32 bits without size casting dis- 
placement expressions. 

(default: norel32) 


(cont.} 
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Tabie 3-2. UNIX/OOS Assembler Command Line Flags (cont.} 


Flag Meaning (positive form) 


Lists the source text on the output listing. 
(default: s) 


Lists the symbol table on the output listing. 
(default: t) 


Prints warnings during the assembly. 
(default: w) 


Lists the cross-reference table on the output listing. The x 
option overrides the symbol table output option, t. If both 
t and x are used, a cross-reference table is generated. 
(default: nox) 
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Invocation Examples 


3-12 


The examples in this section show how to invoke the assembler and specify 
multiple flags on the command line. 


File name extensions in these examples are UNIX-specific and may be different for 
DOS. 


Example: 


% asm68k -h ~f frl,p=68020 -1 > multd.1 multd.s 


The source file multd.s is assembled. The -1 option produces a listing file which 
is redirected from the standard output device to miitd. 1. The output object module 
generated by default is multd.o. The -h option causes production of an HP 
asmb_sym file named multd.A. The assembler will automatically set the d flag to 
place local symbols in the output object module. The £r1 flag forces instructions 
that contain a forward reference to an absolute address to use a 32-bit address. The 
p=68020 flag identifies the target processor as 68020. 


Example: 


% asm68k -o temp.obj -f p=68020 divd.a 


The source file divd.s is assembled. The output listing is not produced because the 
-I option is not used on the command line. The output object module is named 
temp.ob3. The flag p=68020 identifies the target processor as 68020. 


Example: 


% asm68k -h -£ p=68020,x -1 -o modl.o modl >modl.1 


The source file mod1.s is assembled, producing the output listing mod1.1. The 
relocatable object module produced is mod1 .o, The -h option causes the asmb_sym 
file med1.A to be produced as well. Because the ~h option is used, the assembler 
automatically places local symbols in the output object module. The p=68020 flag 
specifies that assembled code is for the 68020 microprocessor. The x flag causes the 
output listing to include a cross-reference table. 
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LNK68K Linker 


There are two ways to invoke the linker: using a command file or using the 
command line (with an optional command file). Using these methods, you can 
produce absolute or relocatable output suitable for incremental linking. If you use 
the incremental link option (-r), which produces a relocatable object module, the 
only linker commands that can be entered are LOAD commands. 


This section describes environment variables affecting the linker, the invocation 
syntax for the LNK68K Linker, and provides examples of different invocation 
methods: 


Environment Variables 


This section describes environment variables that affect LNK68K Linker operation. 
If you use these variables, they must be set before invoking the linker. 


MRI_68K_LIB 


The MRI_68K_LIB environment variable specifies a directory path for files used 
by the LOAD command. The LNK68K Linker will use this path to search for 
libraries and object files. For more information, refer to the LOAD command in 
Chapter 11, Linker Commands, in your Reference Manual. 


Note 


The MRI_68K_LIB environment variable can only be set for one 
directory path at a time. If you have another application that 


requires the MRI_68K_LIB environment variable to be set to a 
different directory path, you will have to reset this variable before 
using that application. 


You can set the MRI_68K_LIB environment variable as follows: 
Using C shell (csh), enter: 
setenv MRI_68K_LIB /my_lib_path 


Using Boume shell (sh), enter: 


MRI_68K_LIB=/my_lib_path 
export MRI_68K_LIB 


For DOS, enter: 
SET MRI_68K_LIBemy_lib_ path 
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TMP (DOS only) 
The TMP environment variable specifies a directory path for temporary files: 
SET TMP=!y_tmpdir 


invocation Syntax 
| Syntax: 


1nk68k [-c command file} {-o output_objectfile} 
[-C command] [-F format) 
(-h] (-H link_symfile] [-1 library]... 
{~m] {-M] [-r] [-u mame} [-v] 
. (input_object_file | ,input_object_file) ...} 


Description: 


1nk66k The invocation name of the linker. 


-c command_file 
Identifies the named file as a command file, which contains 
one or more linker commands. 


-o output_objecifile 
Identifies the named file as the output object module. If this 
option is not specified, the default output file name is 
command file.extension or, if a command file is not 
specified, the first input_object_file.extension, where 


extension is: 
.0 (UNIX) 
obj (DOS) Ifyouuse the -r option, the output object 
module is relocatable. 
«x (UNIX) 


.abs(DOS) If -r, -8, or -h is not used, the output 
object module is absolute in either 
TEEE-695 or Motorola S-Record format. 


xX If you use the -4 or -h option, the output 
object module is in HP format. 
If -<c command _file is not specified, -o output_objectfile 
must be specified to prevent overwriting the first input object 
file (due to the creation of the default output object module 
input_object_file extension). 
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-Cc command Specifies a linker command. This command behaves as 
though it is placed at the top of a command file. Multiple 
linker commands can be specified by -C cmd1 -C cmd2, 
etc. 


Note 


The -f="flag_list" option, which was supported in previous 
versions of the linker, will not be supported in future releases, 
For information about this option, refer to Appendix H, Not 
Supported in Future Releases. 


-F format Specifies the format of the file created by the linker. Legal 
values for format are the same as those for the linker 
FORMAT command and include: 
hp HP-OMF format 
ieee TEEE-695 format (default) 
incremental TEEE-695 format (incremental linking) 
> s Motorola S-Record 
So? noabs No object file is produced; however, 


internal processing is performed and a 
map file will be produced if requested. 


+h Produces an HP 64000-compatible absolute file (HP-OMF) 
and a link_sym file. Sets LISTABS PUBLICS and 
LISTABS INTERNALS. 


The default file extension for the absolute file generated is 
-&. The link_sym file name is the source file root name with 
a .L extension. 


For more information on this option, see the FORMAT HP 
linker command in the Microtec Research ASM68K 
Reference Manual. For more information on HP 64000 
development support, see Appendix A. 


O 
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-8 link_symfile Produces an HP 64000-conipatible absolute file (HP-OMF) 
and a link_sym file. Sets LISTABS PUBLICS and 
LISTABS INTERNALS. 


The default file extension for the absolute file generated is 
.X. The link_sym file name is the source file root name with 
a.L extension. 


For more information on this option, see the FORMAT HP 
linker command in the Microtec Research ASM68K 
Reference Manual. For more information on HP 64000 
development support, see Appendix A. 


-1 library Specifies a library to be searched after all object files have 
been loaded. Multiple libraries can be specified as follows: 
-I fite1.lib -1 fite2.lib. 


-m Indicates that a map file will be written to the standard output 
device. The standard output can be redirected to a file. 


-M Indicates that a map file will be written to the file 
command _file.map or input_object_file.map if there is no 
command file (input_object_file is the name of the first input 


object file specified on the command line). 4 ) 


-r Generates an incremental link. If this option is not specified, 
an absolute file is produced. This option is equivalent to the 
FORMAT INCREMENTAL linker command. 


-u name Creates an external reference for the linker to resolve. This 
option is equivalent to the EXTERN linker command. 


-v Displays the version number of LNK68K and then exits. 


If there is a command file and no options are specified, the following defaults will 
be used: 


command _file.xx (UNIX) or command_file.abs (DOS) 


If there is no command file and no options are specified, the following defaults will 
be used: 
object_file.x (UNIX) or object_file.abs (DOS) 


Refer to the Invocation Examples section for examples of the interactive and non- 
interactive linker invocation modes. 


It is illegal to specify certain combinations of command line options. For example, 
it is illegal to specify both -r and -h. The linker writes an appropriate error message _ 
to the standard error device if an illegal combination is specified. ( ) 
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File Name Defaults 


If an output file name is not specified, the linker uses either the command file name 
(command _file.extension), if present, or the first input object file name 
(input_object_file.extension) as the root file name for generated files. If file name 
extensions (input or output) are not specified, the default extensions listed in Table 
3-3 are assumed. 


Table 3-3. UNIX/DOS Default Linker File Name Extensions 


Input linker command file 
Output HP 64000 link_sym file (-h or -H) 
Output map file (-M) 


Input object file 

Relocatable output object file 

IEEE-695 absolute output object file 
Motorola S-Record absolute output object file 
HP-OMF absolute output object file (-h or -H) 


The linker uses the current defaults if you do not specify a node, device, or 
directory. 


Invocation Examples 


The following examples illustrate various methods of invoking and using the linker. 
Examples shown include multiple flags entered on the command line and 
specifying incremental linking. 


File name extensions in these examples are UNIX-specific and may be different for 
DOS. 


invoking LNK68K with a Command Fite 


This method of invoking the linker lets you specify a command file or both a 
command file and additional object modules on the command line. Object modules 
named on the command line will be loaded before any object module named in the 
command file is loaded. Command files let you set segment addresses, define 
segment loading order, and load a default set of object modules and libraries. 


Command files enter linker commands in batch mode. Any error in the command 
file is considered fatal by the linker and the load is not completed. 


Microtec Research, Inc. 3-17 


UNK68K Linker UNIX / DOS User’s Guide 


Example: 
% Ink68k -c lmult.cmd -m >lmult.map -F s 


The linker reads the command file 1mult . cmd and produces a link map 1mult .map. 
The output object module produced is Imult.x in Motorola S-Record format. 


Example: 
% 1nk68k -c sample.cmd -M -1 lib2.lib modl.o,mod2.0,mod3.o0 


The linker reads the command file sample . cmd, executes the commands in the file, 
and inserts three load commands which load the three object modules, mod1.o, 
mod2.0, and mod3.o. The library 1ib2.1ib is then searched to resolve any 
remaining unresolved extemal references in the loaded modules. The output object 
module is sample.x, and the output map file is sample.map. 


The filé sample .cmd is comprised of the following code: 


CHIP 68000 

LISTMAP PUBLICS 
ORDER SECT2, COMSEC 
PUBLIC ARG3=$3760 
® Load modules 
LOAD testl.o 

LOAD test2.o 

LOAD lib1l.1lib 

END 


The command file processed by the linker will be: 


CHIP 68000 
LISTMAP PUBLICS 
ORDER SECT2,COMSEC 
PUBLIC ARG3=$3760 
* Load modules 
LOAD modl.o 

LOAD mod2,o 

LOAD mod3.o0 

LOAD testl.o 

LOAD test2.o0 

LOAD 1ib1.1ib 
LOAD 1ib2.1ib 


‘Example: 
%& 1lnk68k ~c lmodi -h -m >lmodl.m , 


The command file 2mod1 is read, and the link map 1mcd1.m is produced. If an 
extension had been specified with the command file name, then that command file 
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with the specified extension would have been read. The -h option generates the 
absolute object module Imod1.X in HP-OMF format and the HP link_sym file 
imod1.L. Because the -h option is used, the linker automatically sets the LISTABS 
PUBLICS and LISTABS INTERNALS linker commands, placing external and 
local symbols in the output object module. 


Example: 


% 1nk68k -o sample -i -m >sample.map modl.o mod2.o mod3.o 


The object module files specified on the command line will be named ina LOAD 
command. This LOAD command will be inserted before the first LOAD command 
in the command file, If there is no command file specified, the linker constructs a 
command file consisting of LOAD commands for the object module files. 


The linker loads the three object modules mod1.o, mod2.o0, and mod3.o. The 
resulting incrementally-linked file is sample.o. The link map is sample .map. 


The command file processed by the linker will be: 


LOAD modl.o 
LOAD mod2.o0 
LOAD mod3.o0 
END 


invoking LNK68K Without a Command File 


The object module files specified on the command line will be named in a LOAD 
command. When there is no command file specified, the linker constructs a 
command file consisting of LOAD commands for the object module files. 


Example: 

% Ink68k -o abe -1 def.lib -i -m >abc.map modl.o mod2.o mod3.o0 
The linker loads the three object modules mod1.o, mod2.0, and mod3.o. The 
resulting incrementally-linked file is abe .o. The link map is abc .map. 
The library def.1ib is placed at the end of all the LOAD commands. The 
command file processed by the linker will be: 


LOAD maodl.o 
LOAD mod2.0 
LOAD mod3.o0 
LOAD def.lib 
END 
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LIB68K Librarian 


The Microtec Research LIB68K Object Module Librarian builds and maintains 
program libraries. Libraries are collections of relocatable object modules residing 
in a single file. 


Invocation Syntax 


The command line can be continued on the next line if a minus sign (-) is the last 
character on the line to be continued. 


Only certain library functions can be specified on the command line: ADDMOD, 
DELETE, REPLACE, EXTRACT, and FULLDI. These librarian commands 
can be entered in any order, but the librarian processes the commands in the order 
specified above. Multiple object modules and files must be enclosed in double 


quotes. 
Syntax: 
1ib68k [-a “filename[,filename]...") 
[-d "module_name[,module_name)...") 
[-e “module_name(,module_name)...") 


(-x "filename [, filename) ..."1 
[-1] {-v} library file 


Description: 
1ib68k Invokes the librarian. 


-a "filename[ filename]..." 
Adds the module(s) in the named files to an existing library. - 


~d "module_name[,module_name)...” 
Deletes the named module(s) from the library. 


-e "module_name[,module_name}..." 
Extracts the named module(s) from the library and places 
them in files that have the same name as the module_name. 
The modules are not deleted from the library. 


-x "filename[ filename}..." 


Replaces the module(s) in the library with modules having 
the same name from the specified file(s). 
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-1 Lists the contents of the library named on the command line 
to the standard output device. The standard output can be 
redirected to a file. 

-v Displays the version number of LNK68K and then exits. 

library _file Specifies the library to be read or written. 


File Name Defaults 


The librarian supplies the default file name extensions listed in Table 3-4. 


Table 3-4. UNIX/DOS Default Librarian File Name Extensions 


Command file 


Library file 
Listing file 
Relocatable object file 


This listing file contains output from the internal librarian FULLDIR command. 
This listing file should not be confused with the listing file named on the command 
a line which does not have a default file name extension. 


Default extensions are assumed when you do not append the period (.) extension. 
The librarian looks for a period (.) in the file name, scanning from the right to the 
left, and then compares the extension found to the default (lib). If they are not the 
same, the library will fail. 


Examples: 
If the file name is 1ib.1lib, 
open lib. (this command fails) 
open lib.1 (this command fails) 


open 1lib.1ib (this command succeeds) 
epen lib (this command succeeds) 


C) 
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Invocation Examples 


There are three ways to invoke the LIB68K Librarian: command line mode, 
command file mode, and interactive mode. Examples of these methods are 
described in the sections below. 


Invoking LIB68K Interactively 


You can enter librarian commands interactively from the terminal. A help facility 
is available by typing h or help. 


Example: 
%& 1ib68k 


The librarian prompts you for commands (LIB68K>). When an illegal command is 
entered, the librarian displays an error message and provides an opportunity to re- 
enter the command. In this interactive mode, most librarian command errors are not 
fatal. Multiple object modules or files must be enclosed within double quotes. 


invoking LIB68K from the Command Line 


You can enter librarian commands on the command line. This method can only be 
used to modify an existing library. A new library cannot be created using this 
method. 


Only certain library functions can be specified on the command line: ADDMOD, 
DELETE, REPLACE, EXTRACT, and FULLDIR. FULLDIR implies 
DIRECTORY. These librarian commands can be entered in any order, but the 
librarian collects the commands and processes them in the order listed above. 


Example: 
% 1i3b68k -r "syml.o, sym2.0" -a"modl.o,mod2.0,mod3.0"-1 exlib.lib 


The -a (ADDMOD) option adds modules mod1.o, mod2.0, and mod3.o to the 
library. The -r (REPLACE) option replaces modules symi.o and sym2.o in the 
library exlib.1ib. The contents of ex1ib.1ib are listed to standard output. The 
-r, -d, -a, -e, and -] options can be entered in any order on the command line. The 
librarian will execute the commands in this order: ADDMOD, DELETE, 
REPLACE, EXTRACT, FULLDIR. 
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Invoking LIB68K with a Command File 


You can read librarian commands from a command file in batch mode. The librarian 
processes commands in the command file in the exact order in which they are 
specified. 


Any error encountered when processing the command file is printed, and execution 
of the command that generated the error is not completed. Commands read after the 
first error is encountered are processed, checked for errors, and executed if possible. 
However, if a library file is specified, it is not generated if an error is encountered. 


Example: 
% 1ib68k < command_file 


The librarian commands in command _file will be read in batch mode. Any error 
encountered when processing the command file is printed, and execution of the 
command that generated the error is not completed. A command file is made up of 
a legal sequence of librarian commands. Refer to the Microtec Research ASM68K 
Reference Manual for more details on these commands. 


UNIX/DOS Return Codes 


The assembler, linker, and librarian pass a return code to the operating system upon 
completion of program execution. The return code indicates whether the program 
executed properly or not. The return codes are: 


0 Warning or No Error. 


Either the program ran to completion with no user errors (No Error) 
or there were user-created warnings (Warning). 


1 Execution Error or Fatal Error. 


Either the program ran to completion with user-created assembler, 
linker, or librarian errors (Execution Error) or the program did not 
run to completion due to a system problem (Fatal Error). For 
example, the program was not allocated the required amount of disk 
space, or a file read/write error occurred. 


A message describing the problem will accompany the return code for a warning, 
execution error, or fatal error. 
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Conversion Utility 


The ASM68K. Assembler generates object files in the Microtec Research extended 
IREE-695 format. These files must be passed through a conversion utility before 
they can be input to a native linker. This conversion utility converts the file into 
standard a.out format and is calied iee2Zaout. 


Syntax: 


iee2aout ieeefile aoutfile 


Description: 
iee2aout Invokes the converter. 
ieeefile Specifies the file generated by ASM68K that must be 
converted, 
aoutfile Specifies the name of the converted object module. 


When generating an IEEE object module to be converted by the ieeZaout utility, 
the section names must be renamed using the following compiler options: 

-NC (rename const variable section name) 

-NI (rename initialized data section name) 

-NL (rename compiler-generated literals section name) 

-NS (rename string section name) 

-NT (rename code section name) 

-NZ (rename zerovars section name) 
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HP. 64000 Development 
System Support: 
Appendix A 


ASM68K supports generation of HP 64000 object modules and debugging files that 
can be downloaded and used with the HP 64000 Development System or HP 64700 
emulator. The following development system instruments can be used: 


¢ HP 64700 Emulator 

* HP 64243 Emulator 

e HP 64620 Logic State/Software Analyzer 
e¢ HP 64310 Software Performance Analyzer 


You can generate the object module in HP-OMF format and the associated symbol 
files by using the -h/ -H options (UNIX/DOS) or the /HP option (VMS) on the 
assembler and linker command lines. For the assembler, these options cause 
generation of the asmb_sym file. When you use these options, the assembler 
automatically sets the debug flag, forcing local symbols to be included in the output 
object file. The linker automatically executes the LISTABS PUBLICS and 
LISTABS INTERNALS linker commands to include both external and local 
symbols in the output file and generates a link_sym file. 


For more information on the HP 64000 Development System, see the Section Types 
and HP 64000 Symbolic Files section in Chapter 5, Relocation, of the ASM68K 
Reference Manual. 


HP 64000 Considerations 


When using ASM68K for program development in conjunction with the HP 64000 
development system, you should be aware of several inherent limitations of the HP 
64000. These limitations are: 


¢ The HP 64000 limits symbol names to 15 characters. Therefore, the 
assembler and linker truncate symbols to 15 characters and issue 
diagnostics for symbols whose first 15 characters are not unique. 


¢ Symbols cannot include the characters ?, ., or $. These characters are 
translated to underscores (_ ) by the assembler or are translated by the 
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linker in the case of library routines. This translation can result in 
duplicate symbol errors. 


Sections on the HP 64000 are classified as PROG, DATA, COMN, or 
ABSOLUTE. ASM68K sections must be mapped into these sections. 
ASM68K provides an option on the SECT assembler directive that 
allows the specification of the section type. These types are shown in 
Table A-1 along with how they are mapped into HP 64000 sections. 


Table A-1. Sectlon Types for the HP 64000 Sections 


HP 64000 Section ASM68K Section Type 


C (CODE) 


D (ATA) 
R (ROM) 


If the section type is not explicitly defined, the assembler will attempt to 
make its own decision about how the section is used. It will attempt to place 
the code section in PROG, the uninitialized data section in DATA, and the 
initialized data section in COMN. If there are multiple code sections or 
multiple data sections defined in ASM68K, the second and successive 
sections are mapped into absolute sections. Absolute sections do not have 
local symbol and line number information associated with them. For this 
reason, when debugging, you cannot reference source lines in absolute 
sections. 


The following considerations apply when using the HP 64000 development system 
(but do not apply for the 64700 emulator): 


¢ The HP 64000 uses two special symbols in each routine (Rlabel and 


Elabel) as special identifiers for measurement tools. These symbols 
represent the return point and end address of a routine. The /abel portion 
of the name is the same as the routine name. These labels are generated 
automatically by the Microtec Research MCC68K Compiler when the 
/HP (VMS) or -h (UNIX/DOS) flag is specified at compile time. For 
Programs written in assembly language, you must manually encode 
these labels. 


The HP 64000 microprocessor monitor program must be linked in with 
your code. Therefore, in order to use the 68000 family monitor program, 
it must be uploaded to your host computer, assembled with ASM68K, 
and linked with the application program by LNK68K. However, before 
the monitor can be assembled, it has to be modified to account for 
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incompatibilities between the HP assembly language and the Microtec 
Research/Motorola assembly language. The modifications required are 


minor and are summarized in Table A-2. 


Table A-2. Modifications Required for the 68000 Monitor 


TTL "68000" "68000" 


XDEF SYMBOL GLB SYMBOL 


PAGE 


SKIP 


Hewlett-Packard 
Directive/Instruction 


CMP .L #MONITOR_START, 2 {A7) CMP.L #MONITOR_START, 2[A7] 


MOVE (SP) +, PSTATUS MOVE 
DC.B ‘Error! Entry Mode=User' ASC “Error! Entry Mode=User” 
DC.W REG_END-* DC.W REG_END-$* 


SECTION PROG 
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Reader’s Response 


Please complete and retum the following Reader's Response form to help 
us improve our documentation. Your comments and suggestions are 


always appreciated. 

Product Name Manual Date/Version 

Your Name Title 

Company Address 

Phone Number 

What fs your level of programming experience? In this language? 
Advanced Advanced 
Intermediate Intermediate 
Beginner Beginner 


Circle the number which best expresses your rating of the information in this manual (5 /s the highest rating): 


Complete? 1 2 3 4 § Easy to understand? 1 2 3 4 5 
Accurate? 1 2 3 4 5 Helpful examples? 1 2 3 4 5 
Weilorganized? 1 2 3 4 § Helpful procedures? 1 2 3 4 5 
EasytoFind? 1 2 3 4 5 At an appropriate level? = 1 2 3 4 5 
EasytoRead? 1 2 3 4 § Overall rating? 1 2 3 4 5 


3.) Which programming language do you use? 


4.) Does the manual provide ail the necessary Information? If not, what is missing? 


5.) Are more examples needed? If so, where? 


6.) Did you have any difficulty understanding descriptions or wording? ff so, where? 


7.) Which sections of this manual are the most important? The most helpful? 


8.) What are the best features of this manual? 


9.) What are the areas in this manual that need improvement? 


10.) Did you find any errors in this manual? (Specify section and page number.) 


C 


Software Performance Report instructions 


If problems or errors are encountered when using Microtec Research’s software products (includ- 


ing documentation), a Software Performance Report (SPR) should be completed and returned to: 


Microtec Research 
Software Performance Reports 
2350 Mission College Boulevard 
Santa Clara, CA 95054 


Any comments or suggestions you may have should also be included. All SPRs are directed to our 
Technical Support Department for analysis and response. 


When completing the top section of the SPR, enter the following: 


1, 


> 


een anuawn 


Product name and Version number as it appears on the media label or the banner that 
appears on the screen when the product is invoked. 


. Serial Number as it appears on the media label. 


Name of the person (Customer) that Microtec Research can contact. 
Name of the company that the software was Purchased From. 
Company Name and a shipping Address. 

Phone Number and/or FAX Number of contact name. 

Host (machine where the Microtec Research product is run). 

Host Operating System and Version Number. 


Report Type showing the type of problem reported. 


10. Customer Impact indicating the severity of the problem. 


The following guidelines should be followed when completing the bottom section of the SPR: 


1. 


2. 
3. 


Give as complete a description as possible of the problem, efror, or suggestion, 
including the exact wording of any error messages. 


If possible, isolate the problem by providing a small example. 


If the error example is longer than one page of source code, send all information on a 
tape or floppy disk. 


4. Carefully label any media you send and indicate whether you want it returned to you. 


6. 
7. 


. Include command files, listings, load maps, include files, data files, and all other 


relevant material with the SPR. 
If applicable, send sample input and output listings. 


If the output is from a compiler, send a mixed (source/assembly code) listing. 


If the information on the SPR is complete and concise, it will help us give you accurate and timely 
service to any software problem. 


O 


Software Performance Report 


Customer: 
Company Name/Address 


Product: 


Version: 
Serial Number: 


Purchased From: Phone Number 


Host: [ ] Apollo [ ]HP [ }PC [ ] Other 
{ ]Sun-3 { ]}Sun-4/SPARG []VMS 
Operating System Version 
Report Type: Customer Impact: 
[ ] ProblenvError [ ] Heavy 
[ ] Documentation [ ] Moderate 
[ ] Feature Request [ ] Minor 
{ ] Other 


Problem Description (Attach additional pages if needed): 


Probiem Recreation (Commands ar lines of code used to duplicate prablem): 


Workaround (Attach additional pages If needed): 


O 


Yi Microtec 
Research Inc. 


2350 Mission College Blvd. 

Santa Clara, CA 95054 

Tel. 408.980.1300 

Toll Free 800.950.5554 
FAX 408.982.8266 YQ 


